home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / per09b2.zip / PERSONAL.DOC < prev    next >
Text File  |  1996-01-01  |  14KB  |  325 lines
  1.  
  2.                                 WARNING!!!!
  3.              This BETA documentation may be incomplete or contain
  4.              references to features not yet completed.
  5.  
  6.                     ****************************************
  7.                            ATLANTIS SOFTWARE PRESENTS
  8.                     ****************************************
  9.  
  10.                                 THE PERSONALS
  11.  
  12.                                  Version 0.9 BETA
  13.  
  14.                          Copyright 1996  By Jimmy Rose
  15.                     ****************************************
  16.  
  17.  
  18.  
  19.                       SHAREWARE NOTICE
  20.                        ________________
  21.  
  22.         The Personals is being distributed as shareware. If you
  23.     enjoy this program please register it. Whenever you find any
  24.     shareware Program that you like and find useful, please consider
  25.     registering. This will help encourage future developement of
  26.     other useful programs and also ensure that your favorites will
  27.     be supported and enhanced. 
  28.  
  29.  
  30.                             REGISTERED VERSION INFO
  31.                             _______________________
  32.  
  33.         The Personals requires a registration number to operate in
  34.         registered mode. When you register this program you will receive
  35.         a registration number that is unique to you. No two numbers are
  36.         the same. Place your personal registration number on the second
  37.         line of the sysop.cfg file.
  38.         If you have registered this program then your name will
  39.         appear on the main screen.
  40.  
  41.         The Personals is a copyrighted program!
  42.  
  43.  
  44.                                 INTRODUCTION
  45.                                 ____________
  46.  
  47.         The Personals is a BBS door for writing personal ads such as
  48.         those found in major newspapers across the country.
  49.         This door can be used as a serious means of locating potential
  50.         dates or mates. It can also be used just for fun by seeing
  51.         who can write the most interesting ads.
  52.  
  53.         The Personals Features:
  54.  
  55.               *  Easy set-up and configuration.
  56.               *  Colorful display screens.
  57.               *  Internal Mail.
  58.               *  Users remain anonymous when writing ads & responses.
  59.               *  Sysop may delete any ad.
  60.               *  Sysop can find out who wrote any ad. (1.0 and later)
  61.               *  Multi-Node compatible.
  62.               *  Excellent Support.
  63.  
  64.         It may be configured as a Main Menu item on many boards.
  65.  
  66.         
  67.  
  68.                            REGISTRATION & SUPPORT
  69.                            ______________________
  70.  
  71.         The latest version will always be available for download from
  72.         The Prophecy BBS (513) 423-2336, FidoNet 1:110/950.
  73.         It is a free download on your first call. 
  74.     For registration information see the file "order.txt".
  75.     
  76.     Please see the "Notes" section at the end of this file for
  77.     additional information on obtaining assistance.
  78.  
  79.         If you have any comments, suggestions, or features you'd like
  80.         to see added to The Personals, please write or send E-mail.
  81.         I want to hear your ideas. All questions as will be answered as
  82.         quickly as possible. The Shareware version supports 50 ads,
  83.         and you cannot delete ads till the program is registered.
  84.  
  85.         Atlantis Software products are also available as free downloads
  86.         from various support and distribution sites, please read the
  87.         "support.doc" file for a site near you.
  88.  
  89.  
  90.                                 REQUIREMENTS
  91.                                 ____________
  92.  
  93.         You need an IBM compatible computer and a BBS. This
  94.         door will work with Wildcat, PC Board, Spitfire, Tribbs,
  95.         RBBS, WWIV, Gap, Synchronet, Renegade, Remote Access,
  96.         Proboard, and other BBS's that can run one of these doors.
  97.         It is assumed that you are familiar with your BBS software
  98.         and have installed other doors. If not, step by step instructions
  99.         are provided for some boards. This program may also be run in
  100.         local mode without a BBS (see below).
  101.  
  102.  
  103.                                 QUICK INSTALL
  104.                                 -------------
  105.         This section is a quick setup procedure for experienced Sysops.
  106.         If you need more complete instructions, refer to the "Full
  107.         Installation Procedure" below.
  108.  
  109.         1) Decompress the files into their own directory.
  110.  
  111.         2) Create a directory under the home directory called "mail".
  112.            This can be done by typing "MD mail" (no quotes) from the
  113.            DOS prompt in the program's directory.
  114.  
  115.         3) Edit the "sysop.cfg" file for your BBS. Instructions can
  116.            be found in the file itself, and also later in this file.
  117.  
  118.         4) Write a batch file to call the door for your BBS. The
  119.            command line is "personal c:\bbs\dropfile".
  120.            Example: personal d:\wildcat\wcwork\node1\door.sys
  121.  
  122.         The door can read the following drop files, DOOR.SYS,
  123.         DORINFOx.DEF, CHAIN.TXT, SFDOORS.DAT, EXITINFO.BBS, CALLINFO.BBS.
  124.         However, the use of DOOR.SYS is highly recomended.
  125.  
  126.         You can also run the program locally by typing "personal local".
  127.  
  128.  
  129.                          FULL INSTALLATION PROCEDURE
  130.                          ---------------------------
  131.         Create a directory for The Program. Preferably in your
  132.         BBS directory. You can name it whatever you want. For example,
  133.         if you want to create a directory called "ads" in your BBS
  134.         directory, from the Dos prompt type "cd c:\bbs", then type
  135.         "md ads". Don't type the quotation marks.
  136.         This assumes your BBS is on your c: drive. If it's on another
  137.         drive, substitute the appropriate letter.
  138.  
  139.         After you create the directory, unzip the archive contents
  140.         into it. Next you'll need to modify  the "sysop.cfg" file
  141.         included with the archive. This is an ascii text file that
  142.         can be edited with any text editor. The you MUST create a
  143.         directory under the home directory called mail.
  144.  
  145.                           SYSOP.CFG INSTRUCTIONS
  146.                           ----------------------
  147.         This configuration file MUST be present and MUST be named
  148.         "sysop.cfg". The file is only six lines and the format
  149.         is as follows:
  150.  
  151.         Line 1 is the name of your BBS.
  152.         Line 2 is the name of the person this program is registered to.
  153.         Line 3 is your registration number, or 0 if unregistered.
  154.         Line 4 is the Sysop security level for accessing the Sysop Editor.
  155.         Line 5 is the number of current ads each user is allowed to have.
  156.         Line 6 is one character, either A if your BBS uses Alias's
  157.                or R if your BBS uses Real names. Use capital letters.
  158.         Line 7 is the full path to The Personals home directory.
  159.  
  160.         All lines must be present and there must not be any blank lines.
  161.         A sample sysop.cfg file is also included with instructions contained
  162.         in the file.
  163.  
  164.         Here is a sample sysop.cfg file from The Prophecy
  165.         -------------------------------------------------
  166.         The Prophecy
  167.         Jimmy Rose
  168.         12345678
  169.         200
  170.         5
  171.         A
  172.         d:\doors\personal
  173.  
  174.         The next step is to create a batch file to call the door. Each
  175.         BBS is different, so it's assumed you know how to create one
  176.         for your system. Here's a sample batch file for TriBBS:
  177.  
  178.                 cd c:\tribbs\personal
  179.                 personal.exe d:\tribbs\door.sys
  180.                 cd c:\tribbs
  181.                 board
  182.  
  183.         The first line changes to the directory where The program
  184.         is located.
  185.         The second line calls the door followed by the full path to
  186.         the dropfile.
  187.         The third and fourth lines return you to the board.
  188.         Each system will be a little different, the one line that will
  189.         be same for every system is the second one.
  190.         Finally, edit your bbs files to display the door name and call
  191.         the batch file when selected. You're on your own here!
  192.  
  193.         This program can easily be run from your Main Menu on
  194.         systems with extendable menus. It is recommended you do run
  195.         the program from the Main Menu if your system supports this.
  196.  
  197.         To set up The Personals as a Main Menu item on a Tribbs
  198.         system, name the above batch file "mainv.bat", then edit your
  199.         main.mnu file to call the batch file by adding the following
  200.         line:
  201.         V,V,The Personals,20
  202.  
  203.         This will call up The Personals whenever the letter V is
  204.         selected from the Main Menu. You may use any availabe letter
  205.         that you like, just substitute the letter you want to use for
  206.         the letter V in all instances above, including the batch file.
  207.         The number at the end of the line is the minumum security level
  208.         a user must have to be able use this program. Adjust this
  209.         to your liking.
  210.  
  211.  
  212.                                  OPERATION
  213.                                  ---------
  214.         This program may be run locally if you wish. If you want
  215.         to run the door without going through the BBS, make the directory
  216.         where the program is stored the current directory. From the Dos
  217.         prompt type "personal local". You will prompted to enter a
  218.         user name. Whatever name you type in will be used for your Alias.
  219.  
  220.         When The Personals loads you will see a list of commands.
  221.         Here are the Main Menu commands:
  222.      
  223.         W - Write an Ad:
  224.             This command let's you write your own personal ad.
  225.             The Sysop may set the maximum number of ads per user
  226.             in the "sysop.cfg" file.
  227.  
  228.         B - Browse Ads:
  229.             Browse through all ads currently available. Male ads
  230.             will be shown with a blue background and female Ads
  231.             will have a magenta background. You may quit at any
  232.             time be pressing 'Q' or respond to any ad by pressing
  233.             'R'.
  234.  
  235.         D - Display an Ad:
  236.             Displays a specific Ad. You'll be prompted for an Ad
  237.             number.
  238.  
  239.         R - Respond to an Ad:
  240.             This command let's you leave private mail in the mail
  241.             box of the user who left the Ad.
  242.             
  243.         M - Mail Box:
  244.             Takes you to the Mail Box Menu where you can read waiting
  245.             messages. Each user has their own private mail box.
  246.  
  247.         Q - Quit and Return to the BBS:
  248.             Exits The Personals and returns to the bbs.
  249.      
  250.         S - Sysop Editor:  (NOT COMPLETED YET)
  251.             This choice is only displayed when the user has Sysop security
  252.             level as declared on line 3 of the Sysop.cfg file.
  253.             This command accesses the Sysop functions.
  254.  
  255.         Here are the Mail Box Menu commands:
  256.  
  257.         R - Read Mail:
  258.             Let's you read your mail. You can save messages and reply
  259.             later if you want.
  260.  
  261.         D - Delete Mail:
  262.             Let's you delete old mail that is no longer needed, only
  263.             if the program is registered.
  264.  
  265.  
  266.                                HINTS & TIPS
  267.                                ------------
  268.  
  269.         Whenever possible configure the door to run from your Main Menu.
  270.         Post a news item to let users know that the door has been installed
  271.         and what it is.
  272.  
  273.         The Personals can be used as a serious matchmaking utility, or it
  274.         can be used just for fun by seeing who can write the most interest-
  275.         ing ads.
  276.  
  277.  
  278.         Common Problems:
  279.  
  280.         "It looks fine on the sysop end, but users only see garbage on the
  281.         screen when they enter the door."
  282.         This is always a configuration error. Double check your config
  283.         files and make sure your RTS/CTS flow control is on.
  284.  
  285.  
  286.                                     NOTES
  287.                                     _____
  288.  
  289.         IMPORTANT! The program data is contained in the files "person.usr"
  290.         and "personal.ads"
  291.         DO NOT attempt to modify these files! It is a good idea to make
  292.         a backup copy of these file at least once a week.
  293.  
  294.         Thanks to all my beta testers and distribution sites
  295.         for their input and feedback. Check out the "support.doc"
  296.         for a complete listing.
  297.  
  298.         This program was written in C++ using Borland C++.
  299.  
  300.         If you have any questions, comments, or suggetions please write
  301.         to:
  302.  
  303.                 Jimmy Rose
  304.                 2000 Linden ave.
  305.                 Middletown, OH 45044-4435
  306.                 USA
  307.  
  308.         Or call the Home of Atlantis Software:
  309.         The Prophecy BBS (513) 423-2336 or (513) 423-1829
  310.         24 hours a day.
  311.         Send Netmail to: Fido 1:110/950
  312.  
  313.         If you do have a problem and call or write, please be prepared to
  314.         provide the following information:
  315.         > Program version number.
  316.         > BBS Software & version number.
  317.         > Serial port used? (locked?, rate?).
  318.         > Does your BBS use nonstandard IRQ's?
  319.         > Does your BBS use Alias's?
  320.         > A copy of your current batch files for this program.
  321.         > Any thing else "specific" to your problem.
  322. *****************************************************************************
  323.             THANKS FOR USING THE PERSONALS!
  324. *****************************************************************************
  325.